<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
    <head>
        <title>CruiseControl.NET : PVCS Source Control Block</title>
	    <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">	    
    </head>

    <body>
	    <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
		    <tr>
			    <td valign="top" class="pagebody">
				    <div class="pageheader">
					    <span class="pagetitle">
                            CruiseControl.NET : PVCS Source Control Block
                                                    </span>
				    </div>
				    <div class="pagesubheading">
					    This page last changed on Sep 11, 2008 by <font color="#0050B2">williams</font>.
				    </div>

				    <p>CruiseControl.NET supports integrating with the PVCS Source Control system via the <b>pcli</b> client.</p>

<h3><a name="PVCSSourceControlBlock-PVCSConfigurationExamples"></a>PVCS Configuration Examples</h3>

<p>For the PVCS provider you must specify the executable, project and subproject. Additional optional arguments are defined in the table below.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;sourcecontrol type=<span class="code-quote">"pvcs"</span>&gt;</span>
   <span class="code-tag">&lt;executable&gt;</span>c:\pvcs\pvcs.exe<span class="code-tag">&lt;/executable&gt;</span>
   <span class="code-tag">&lt;project&gt;</span>ccnet<span class="code-tag">&lt;/project&gt;</span>
   <span class="code-tag">&lt;subproject&gt;</span>ccnet1.0<span class="code-tag">&lt;/subproject&gt;</span>
<span class="code-tag">&lt;/sourcecontrol&gt;</span></pre>
</div></div>

<h3><a name="PVCSSourceControlBlock-ConfigurationElements%3A"></a>Configuration Elements:</h3>

<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Node </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Default </th>
<th class='confluenceTh'> Required </th>
</tr>
<tr>
<td class='confluenceTd'> executable </td>
<td class='confluenceTd'> The PVCS client executable. </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> pcli </td>
<td class='confluenceTd'> true </td>
</tr>
<tr>
<td class='confluenceTd'> project </td>
<td class='confluenceTd'> The location of the PVCS project database </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> n/a </td>
<td class='confluenceTd'> true </td>
</tr>
<tr>
<td class='confluenceTd'> subproject </td>
<td class='confluenceTd'> One ore more projects in PVCS that you wish to monitor.  As long as each subproject is separated with a space and a "/", you can monitor more than one subproject at a time. </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> n/a </td>
<td class='confluenceTd'> true </td>
</tr>
<tr>
<td class='confluenceTd'> username </td>
<td class='confluenceTd'> Username for the user account to use to connect to PVCS </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> n/a </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> password </td>
<td class='confluenceTd'> Password for the PVCS user account </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> n/a </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> workingdirectory </td>
<td class='confluenceTd'> The local directory containing the source from the repository. </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> n/a </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> recursive </td>
<td class='confluenceTd'> Whether to monitor all subfolders of the specified subproject </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> true </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> labelOnSuccess </td>
<td class='confluenceTd'> Whether or not to apply a label to the repository after each successful build. </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> autoGetSource </td>
<td class='confluenceTd'> Specifies whether the CCNet should take responsibility for retrieving the current version of the source from the repository </td>
<td class='confluenceTd'> bool </td>
<td class='confluenceTd'> true </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> labelOrPromotionName </td>
<td class='confluenceTd'> The label to use as your code-base.  If this is specified, this label will be called to get all code associated with it when a <b>get</b> is done.  When the build is successful, the good code will have this base label associated with it in turn promoting it into the label.<br clear="all" />
 Label to apply to repository. If a value is specified, <b>labelOnSuccess</b> will automatically be set to true. </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> n/a </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> timeout </td>
<td class='confluenceTd'> Sets the timeout period for the source control operation. See <a href="Timeout Configuration.html" title="Timeout Configuration">Timeout Configuration</a> for details. </td>
<td class='confluenceTd'> Timeout </td>
<td class='confluenceTd'> 10 minutes </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> manuallyAdjustForDaylightSavings </td>
<td class='confluenceTd'> In PVCS 7.5.1, the client does not automatically adjust dates to accommodate daylight savings time. Setting this flag to true will make CCNet compensate for it. This flag is available in CCNet 1.2.2 and later. </td>
<td class='confluenceTd'> boolean </td>
<td class='confluenceTd'> false </td>
<td class='confluenceTd'> false </td>
</tr>
<tr>
<td class='confluenceTd'> issueUrlBuilder </td>
<td class='confluenceTd'> Converts the comment (or parts from it) into an url pointing to the issue for this build. <br clear="all" />
See <a href="IssueUrlBuilder.html" title="IssueUrlBuilder">Issue Builder</a> for more details <br clear="all" /> </td>
<td class='confluenceTd'> Group </td>
<td class='confluenceTd'> N/A </td>
<td class='confluenceTd'> false <br clear="all" /> </td>
</tr>
</tbody></table>

<ul>
	<li>Code contributed by James Bolles</li>
</ul>


				    
                    			    </td>
		    </tr>
	    </table>
	    <table border="0" cellpadding="0" cellspacing="0" width="100%">
			<tr>
				<td height="12" background="http://confluence.public.thoughtworks.org//images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
			</tr>
		    <tr>
			    <td align="center"><font color="grey">Document generated by Confluence on Sep 29, 2009 20:59</font></td>
		    </tr>
	    </table>
    </body>
</html>